# Flarum Russian Language Pack (UNOFFICIAL)

![Flarum Russian Language Pack](https://upload.wikimedia.org/wikipedia/commons/thumb/9/94/Flag-map_of_Russia.svg/2560px-Flag-map_of_Russia.svg.png)

Пакет русской локализации движка [**Flarum**](https://flarum.org/) - программного обеспечения нового поколения для создания сообществ. Реализована поддержка единичных и множественных чисел (переменных).

Все фразы взяты в двойные кавычки для предотвращения конфликтов со знаками препинания, потому что их в русском языке используется большее количество, по сравнению с английским.

## Установка

**Flarum** использует [**Composer**](https://getcomposer.org/) для управления зависимостями и расширениями.

Русский пакет локализации доступен в [**Packagist**](https://packagist.org/packages/pkgstore/flarum-l10n-russian) и может быть установлен при помощи **Composer**.

Убедитесь, что **Composer** установлен на вашем компьютере, и введите следующую команду в терминале, находясь в корневой директории **Flarum**:

```sh
composer require pkgstore/flarum-l10n-russian
```

Так же, данная команда может быть использована для обновления языкового пакета, без обновления сторонних компонентов.

Обратите внимание, что пакет локализации будет добавлен в качестве зависимости **Flarum**, и он также будет автоматически обновляться при обновлении движка форума.

## Обновление

Для обновления локализации необходимо выполнить следующие команды:

```sh
composer update pkgstore/flarum-l10n-russian
php flarum cache:clear
```

## Удаление

Для удаления локализации необходимо выполнить следующие команды:

```sh
composer remove pkgstore/flarum-l10n-russian
php flarum cache:clear
```

## От автора или что такое "неофициальная локализация"

Здравствуйте!

Я развиваю две локализации Flarum:

1. [официальная](https://github.com/flarum-lang/russian);
2. [неофициальная](https://github.com/pkgstore/flarum-l10n-russian).

Неофициальная локализация отличается лишь тем, что используется только на моих проектах. Все изменения в неофициальной версии переносятся в официальную.

Почему произошло разделение? Во первых, пакет официальной локализации очень большой, включает в себя не только переводы модулей ядра, но и переводы множества различных расширений.

Неофициальная локализация разделена на два пакета:

1. Переводы модулей ядра.
2. Переводы расширений.

Пакет с переводами расширений содержит только локализации наиболее востребованных, по моему мнению, расширений.

## Генератор JSON

Для генерации JSON из YAML используется утилита [yq](https://github.com/mikefarah/yq).

### Синтаксис

```sh
for i in *.yml; do yq eval -o=j "${i}" > "json/${i%.*}.json"; done;
```
